From 7f504fdfa00c954ab29cda6010be493d8c0b12fd Mon Sep 17 00:00:00 2001
From: =?utf8?q?Javier=20Jard=C3=B3n?= <jjardon@gnome.org>
Date: Wed, 13 Apr 2011 00:49:30 +0100
Subject: [PATCH] Move documentation to inline comments: GtkFrame

---
 docs/reference/gtk/tmpl/.gitignore       |   1 +
 docs/reference/gtk/tmpl/gtkframe.sgml    | 160 -----------------------
 docs/reference/gtk/tmpl/gtkmenuitem.sgml |  18 +++
 gtk/gtkframe.c                           |  37 ++++++
 4 files changed, 56 insertions(+), 160 deletions(-)
 delete mode 100644 docs/reference/gtk/tmpl/gtkframe.sgml

diff --git a/docs/reference/gtk/tmpl/.gitignore b/docs/reference/gtk/tmpl/.gitignore
index 1ceddcfe83..6ac20b648b 100644
--- a/docs/reference/gtk/tmpl/.gitignore
+++ b/docs/reference/gtk/tmpl/.gitignore
@@ -37,6 +37,7 @@ gtkfixed.sgml
 gtkfilechooserwidget.sgml
 gtkfilefilter.sgml
 gtkfontbutton.sgml
+gtkframe.sgml
 gtkhbox.sgml
 gtkhpaned.sgml
 gtkhscale.sgml
diff --git a/docs/reference/gtk/tmpl/gtkframe.sgml b/docs/reference/gtk/tmpl/gtkframe.sgml
deleted file mode 100644
index 2ef729fe66..0000000000
--- a/docs/reference/gtk/tmpl/gtkframe.sgml
+++ /dev/null
@@ -1,160 +0,0 @@
-<!-- ##### SECTION Title ##### -->
-GtkFrame
-
-<!-- ##### SECTION Short_Description ##### -->
-A bin with a decorative frame and optional label
-
-<!-- ##### SECTION Long_Description ##### -->
-<para>
-The frame widget is a Bin that surrounds its child
-with a decorative frame and an optional label.
-If present, the label is drawn in a gap in the
-top side of the frame. The position of the
-label can be controlled with gtk_frame_set_label_align().
-</para>
-
-<refsect2 id="GtkFrame-BUILDER-UI">
-<title>GtkFrame as GtkBuildable</title>
-<para>
-The GtkFrame implementation of the GtkBuildable interface
-supports placing a child in the label position by specifying
-"label" as the "type" attribute of a &lt;child&gt; element.
-A normal content child can be specified without specifying 
-a &lt;child&gt; type attribute.
-</para> 
-<example>
-<title>A UI definition fragment with GtkFrame</title>
-<programlisting><![CDATA[
-<object class="GtkFrame">
-  <child type="label">
-    <object class="GtkLabel" id="frame-label"/>
-  </child>
-  <child>
-    <object class="GtkEntry" id="frame-content"/>
-  </child>
-</object>
-]]></programlisting>
-</example>
-</refsect2>
-
-<!-- ##### SECTION See_Also ##### -->
-<para>
-
-</para>
-
-<!-- ##### SECTION Stability_Level ##### -->
-
-
-<!-- ##### SECTION Image ##### -->
-
-
-<!-- ##### STRUCT GtkFrame ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### ARG GtkFrame:label ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkFrame:label-widget ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkFrame:label-xalign ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkFrame:label-yalign ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkFrame:shadow-type ##### -->
-<para>
-
-</para>
-
-<!-- ##### FUNCTION gtk_frame_new ##### -->
-<para>
-</para>
-
-@label: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_frame_set_label ##### -->
-<para>
-</para>
-
-@frame: 
-@label: 
-
-
-<!-- ##### FUNCTION gtk_frame_set_label_widget ##### -->
-<para>
-
-</para>
-
-@frame: 
-@label_widget: 
-
-
-<!-- ##### FUNCTION gtk_frame_set_label_align ##### -->
-<para>
-</para>
-
-@frame: 
-@xalign: 
-@yalign: 
-
-
-<!-- ##### FUNCTION gtk_frame_set_shadow_type ##### -->
-<para>
-</para>
-
-@frame: 
-@type: 
-
-
-<!-- ##### FUNCTION gtk_frame_get_label ##### -->
-<para>
-
-</para>
-
-@frame: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_frame_get_label_align ##### -->
-<para>
-
-</para>
-
-@frame: 
-@xalign: 
-@yalign: 
-
-
-<!-- ##### FUNCTION gtk_frame_get_label_widget ##### -->
-<para>
-
-</para>
-
-@frame: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_frame_get_shadow_type ##### -->
-<para>
-
-</para>
-
-@frame: 
-@Returns: 
-
-
diff --git a/docs/reference/gtk/tmpl/gtkmenuitem.sgml b/docs/reference/gtk/tmpl/gtkmenuitem.sgml
index 83a554f04e..881646eef2 100644
--- a/docs/reference/gtk/tmpl/gtkmenuitem.sgml
+++ b/docs/reference/gtk/tmpl/gtkmenuitem.sgml
@@ -324,3 +324,21 @@ Emits the "toggle_size_allocate" signal on the given item.
 @allocation: the allocation to use as signal data.
 
 
+<!-- ##### FUNCTION gtk_menu_item_get_reserve_indicator ##### -->
+<para>
+
+</para>
+
+@menu_item: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_menu_item_set_reserve_indicator ##### -->
+<para>
+
+</para>
+
+@menu_item: 
+@reserve: 
+
+
diff --git a/gtk/gtkframe.c b/gtk/gtkframe.c
index 62e0dc160e..5f201cce18 100644
--- a/gtk/gtkframe.c
+++ b/gtk/gtkframe.c
@@ -34,6 +34,43 @@
 #include "gtkbuildable.h"
 
 
+/**
+ * SECTION:gtkframe
+ * @Short_description: A bin with a decorative frame and optional label
+ * @Title: GtkFrame
+ *
+ * The frame widget is a Bin that surrounds its child
+ * with a decorative frame and an optional label.
+ * If present, the label is drawn in a gap in the
+ * top side of the frame. The position of the
+ * label can be controlled with gtk_frame_set_label_align().
+ *
+ * <refsect2 id="GtkFrame-BUILDER-UI">
+ * <title>GtkFrame as GtkBuildable</title>
+ * <para>
+ * The GtkFrame implementation of the GtkBuildable interface
+ * supports placing a child in the label position by specifying
+ * "label" as the "type" attribute of a &lt;child&gt; element.
+ * A normal content child can be specified without specifying
+ * a &lt;child&gt; type attribute.
+ * </para>
+ * <example>
+ * <title>A UI definition fragment with GtkFrame</title>
+ * <programlisting><![CDATA[
+ * <object class="GtkFrame">
+ *   <child type="label">
+ *     <object class="GtkLabel" id="frame-label"/>
+ *   </child>
+ *   <child>
+ *     <object class="GtkEntry" id="frame-content"/>
+ *   </child>
+ * </object>
+ * ]]></programlisting>
+ * </example>
+ * </refsect2>
+ */
+
+
 #define LABEL_PAD 1
 #define LABEL_SIDE_PAD 2
 
-- 
2.30.2